14 OveERVIEW 


Keywords can be subdivided into functions, which return a value, and commands, which 
do not. In practice you use functions and commands together, often using functions as if 
they were commands, ignoring the values they return. 


This chapter lists all the keywords, grouped according to their purpose. Use this chapter 
if you know what you’d like to do, but not which function or command will do it. 


The chapter which follows this one lists the keywords alphabetically, with explanations 
and full specifications. 
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PROGRAM CONTROL 


Loops, branches, jumps 
Repeat a set of instructions 


DO...UNTIL, WHILE...ENDW 


Do either one set of instructions or another set, or another, or another... IF...ENDIF 


Go... 
...to a specified label 
...to one of a list of labels 
...to the end/start of a repeating set of instructions 
...back to the calling procedure 
End the program 


Error handling 


Raise an error 

Put an explanatory comment in your program 
Declare an error-handler 

Let the program continue after an error 


After an error, find out what the error was 


Tan 
T After an error, find out what the extended error message was ERRX$ 


SCREEN AND KEYBOARD CONTROL 


Display a string to be edited and get a value from the keyboardEDIT 


Get a value from the keyboard 
Display text, numbers etc. 
Set screen update method 
Pause... 
..for a number of seconds 
..until a key is pressed 
Position or hide the cursor 
Clear the text window 
Sound the buzzer 
Set the size/position of the text window 
Get information on the text window 
Set text window font and style 
Find out which key was pressed, if any 
Find out what combination of modifiers was pressed 
Disable/enable stopping from a running program 


Turn the Psion off 
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GOTO 
VECTOR...ENDV 


BREAK, CONTINUE 


RETURN 
STOP 


RAISE 

REM 
ONERR...ONERR OFF 
TRAP 

ERR, ERR$ 


INPUT 
PRINT 
gUPDATE 


PAUSE 

GET, GET$ 
AT, CURSOR 
CLS 

BEEP 
SCREEN 


SCREENINFO 


FONT, STYLE 

KEY, KEY$, GET, GET$ 
KMOD 

ESCAPE OFF/ON 

OFF 


FiLes 

General file management 
Copy a file 

Delete or rename a file 

Check to see if a certain file exists 


Find out what files there are 


OPL procedures and modules 


I set up a procedure cache 


Load an OPL module file so you can use the procedures in it 


Remove a module from memory 


lan 
T Include a file containing constant definitions and 


procedure prototypes 


Tan 
I Cause a error to be raised by the translator if a procedure or 


variable is used before it is declared 


Tan 
I Declare a procedure or variable as external 


Data files and databases 
Create a new data file, databse or table 


OPEN or CLOSE a data file, database or table 


I Delete a table from a database 


Use a different data file that has been opened 


I Copy a data file, optionally appending to another data file, 


and removing deleted records 


Once a data file has been OPENed, you can: 

Make a new record 

Change a record 

Search for those records which contain a certain string 
Erase a record 


Move to a different record 


Count the records 
Find whether you’re at the end of the file yet 


Find the current record number 


I Find the number of bytes used by the current record 


COPY 

DELETE, RENAME 
EXIST 

DIR$ 


LOADM 
UNLOADM 


INCLUDE 


DECLARE EXTERNAL 


EXTERNAL 


CREATE 


OPEN, OPENR, CLOSE 


DELETE 
USE 


COMPRESS 


APPEND 

UPDATE 

FIND, FINDFIELD 
ERASE 

FIRST, LAST, NEXT, 
BACK, POSITION 
COUNT 

EOF 

POS 


RECSIZE 
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lan 
I Begin a transaction 


an 
I Commit a transaction 


aw 
I Find out whether the current view is in transaction 


I Cancel the transaction 

I Insert a bookmark 

I Goto a bookmark 

I Delete a bookmark 

I Insert a new blank record 

i Modify a record 

I Make changes to a database permanent 

I Cancel changes made to a database 

I Compact a database (see COMPRESS) 


Managing directories 
Create directory 


Set current directory 


Remove directory 


Memory 


Declare variables 


an 
I Declare a constant 


Find how much free memory there is on a device 


PRINTING 


Specify a device or file to print to 


Close the print device or file opened with LOPEN 


Print to a device or file 
NumBERS 


Trigonometry 
Trig functions 


Convert between degrees and radians 


Other functions 


Raise e to a power 


Logarithms 
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BEGINTRANS 


COMMITTRANS 


INTRANS 


ROLLBACK 


BOOKMARK 


GOTOMARK 


KILLMARK 


INSERT 


MODIFY 


PUT 


CANCEL 


COMPACT 


MKDIR 
SETPATH 
RMDIR 


GLOBAL, LOCAL 


CONST 
SPACE 


LOPEN 
LCLOSE 
LPRINT 


COS, SIN, TAN, ACOS, 
ASIN, ATAN 


RAD, DEG 


EXP 
LN, LOG 


Pi as a constant 


Square root 


Use random numbers 


PI 
SOR 
RND, RANDOMIZE 


Unsigned integer/pointer arithmetic (in the 64K limit) UADD, USUB 
Lists of numbers 
Find the greatest or smallest value in the list MAX, MIN 
Average the list MEAN 
Add up the list SUM 
Find the standard deviation or variance STD, VAR 
Changing the format of numbers 
Knock the minus sign off a number ABS, IABS 
Take whole number, removing any fractional part INT, INTF 
Convert... 

..an integer into floating-point FLT 

..an integer into a hexadecimal string HEX$ 

...a number into a string FIX$, GEN$ SCI$, NUM$ 

...a string into a number EVAL, VAL 
STRiNGs 


Copy characters from a string 


Repeat a string 


Make a string upper or lower case 


Find out... 


.-how long a string is 


...the character code of the first character of a string 


...where a certain string is within a string 


Convert... 


... a String of digits to a number 


...a number to a string 


Get the character with a certain character code 


DATE AND TIME 


Find out the current date and time... 


Find out... 


..as a string 
...Just the current time 


...Just the current date 


...the number of days between two dates 


...what day of the week, or what week number, a certain 


date falls in 


LEFTS$, MIDS, RIGHTS 
REPTS 
UPPERS, LOWERS 


LEN 
ASC 
LOC 


VAL 


FIX$, GEN$ SCI$, NUM$ 
CHR$ 


DATIM$ 
SECOND, MINUTE, HOUR 
DAY, MONTH, YEAR 


DAYS 


DOW, WEEK 
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Express... 
... 1-12 as the name of a month 
... 1-7 as a day of the week 


Convert between seconds and dates 


I Convert between days and dates 
GRAPHICS 


Drawing commands 
Set current position 


I Set current pen width 
Draw a line 


Draw a sequence of lines 
Tan 
I Draw a circle 


i Draw an ellipse 

Draw a rectangle 

Draw a border 

Fill a rectangle 

Invert a rectangle 

Scroll a rectangle 

Get current position 
Display a running clock 


Draw a 3-D button (key) 


IDrawa lozenge 


Displaying graphics text 
Display a list of expressions 
Display text in a cleared box 
Display text neatly clipped 

Find width required by text 
Display text underlined/highlighted 


Setting styles 
Set graphics to set / clear / invert pixels 


Set text to set / clear / invert / replace pixels 


Set font to use 


Load and unload user-defined fonts 


Set text to bold / underline / inverse / double / mono / italic 
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MONTH$ 
DAYNAME$ 


DATETOSECS, 
SECSTODATE 


DAYSTODATE 


gAT, gMOVE 


gSETPENWIDTH 


gLINEBY, gLINETO 


gPOLY 


gCIRCLE 


gELLIPSE 


gBOX 


gBORDER, gXBORDER 


gFILL 
gINVERT 
gSCROLL 
gX, gY 
gCLOCK 
gBUTTON 


gDRAWOBJECT 


gPRINT 
gPRINTB 
gPRINTCLIP 
gTWIDTH 
gXPRINT 


gGMODE 
gTMODE 
gFONT 


gLOADFONT, 
gUNLOADFONT 


gSTYLE 


Windows and bitmaps 


Create a new window 

Set position and/or size of a window 
Set order to show windows 

Get order of a window 

Set window visible / invisible 

Get screen position of a window 
Create a bitmap 

Load a bitmap from file 

Clear a window / bitmap 

Save window / bitmap to bitmap file 
Close down a window / bitmap 


Set which window / bitmap to use 


an 
I set foreground colour of current window 


I Swap between grey and black pens 
I set grey on/off in a window 
I Set colour mode of default window 


I Enable grey in default window 


Fill an area with repetitions of another window / bitmap 
Copy an area from one window / bitmap to another 


Read data back from a window / bitmap 


Get ID number of a window / bitmap 


Get size of a window / bitmap 


NX 
I Get status information about a drawable and about the cursorgINFO 


Tan 
I Get status information about a drawable and about the cursor 


I Sprites 
Create a sprite 


Define bitmap-sets for a sprite 


Draw a sprite 
Set a sprite’s position 


Close a sprite 


MeNus 


Start a new set of menus 


Define a menu 


gCREATE 
gSETWIN 
gORDER 
gRANK 
gVISIBLE 
gORIGINX, gORIGINY 
gCREATEBIT 
gLOADBIT 
gCLS 
gSAVEBIT 
gCLOSE 
gUSE 


gCOLOR 


gGREY 
gGREY 
DEFAULTWIN 


DEFAULTWIN 
gPATT 

gCOPY 
gPEEKLINE 
gIDENTITY 
gWIDTH, gHEIGHT 


gINFO32 


CREATESPRITE 


APPENDSPRITE, 
CHANGESPRITE 


DRAWSPRITE 
POSSPRITE 
CLOSESPRITE 


mINIT 
mCARD 
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an 
I Define a cascade for a menu 


Display menus 
I Define a popup menu 


DiaLocs 
Start a new dialog 


Position a dialog 
Define text for a dialog 


Define an edit box for a dialog 


I Defines a multi-line edit box for a dialog 


Define a secret edit box for a dialog 
Define a filename edit box for a dialog 


Define a choice list for a dialog 


I Defines an item with a checkbox for a dialog 
Define a numeric edit box for a dialog 

Define a date or time edit box for a dialog 
Define exit keys for a dialog 

Display a dialog 

Display a simple ‘alert’ dialog 

SERIES 3c AND SIENA STATUS WINDOW 
Display/hide status window 

Get status window information 


Set a program’s name 
Initialise a ) list 


Position (2) ona (2) list 


SCREEN MESSAGES 


Display information messages 


Display ‘busy’ messages 


OPL APPLICATIONS 
Define an OPA 


Declares an OPAs icon 

i Give an OPAs caption in the given language 
I Specify whether an OPA is document-based 
I Set the type of an OPA 


I Give the file extension used by an OPA 
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mCASC 
MENU 


mPOPUP 


dINIT 
dPOSITION 
dTEXT 
dEDIT 


dEDITMULTI 


dXINPUT 


dFILE 
dCHOICE 


dCHECKBOX 
dFLOAT, d(LONG 
dDATE, dTIME 
dBUTTONS 
DIALOG 

ALERT 


STATUSWIN 
STATWININFO 
SETNAME 


DIAMINIT 


DIAMPOS 


GIPRINT 
BUSY 


APP...ENDA 
ICON 


CAPTION 
FLAGS 
TYPE 


EXT 


I Give the directory to use for an OPA’s files 


Mark an OPA as locked or unlocked 


ADVANCED USE 

I Run machine code 

Find out where a certain variable is in memory 

Store a value in a specific place in memory 

Find out the value stored at a certain place in memory 
Open any type of file 

Read from a file opened with IOOPEN 

Write to a file opened with IOOPEN 

Close a file opened with IOOPEN 

Position within a file opened with IOOPEN 


Keywords which provide low-level access to the Psion 


I call an operating system service 

Perform an asynchronous I/O function 

Cancel an asynchronous I/O function 

Wait for completion of a function performed by IOA or IOC 
I Wait for completion an asynchronous OPX procedure 


Signal completion of an I/O function 
Ensure an asynchronous handler runs 
Perform a synchronous I/O function 
Perform an asynchronous keyboard read 
Cancel a KEYA 


Get command line information 


I Set a file to be a document 


Tan 
I Get the name of the current document 


Parse a full file specification 


Check for system events 


I Check for system and pointer events 


I Fitter pointer events out or reinstate them 
I Get system-level info on data files 
T Load/link a DYL 


I Unload a DYL 


PATH 


LOCK 


USR, USR$ 
ADDR 
POKE commands 


PEEK commands 


IOOPEN 
IOREAD 
IOWRITE 
IOCLOSE 
IOSEEK 


CALL, OS 


IOA, IOC 
IOCANCEL 
IOWAIT, IOWAITSTAT, 


IOWAITSTAT32 
IOSIGNAL 
IOYIELD 

IOW 

KEYA 

KEYC 

CMD$, GETCMD$ 


SETDOC 


GETDOC$ 
PARSE$ 


GETEVENT, TESTEVENT 


GETEVENT32, 
GETEVENT32A 


POINTERFILTER 


ODBINFO 


LOADLIB, LINKLIB 


UNLOADLIB 
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I Fina category handles 
I Create new objects 


Isenda message to an object 


Allocate a heap cell 

Free an allocated cell 

Change size of allocated cell 
Insert or delete section of cell 


Find length of allocated cell 


XX 
I Remove returned procedures from a cache 


I Read cache index header 


I Read cache index record 


I set flags (mainly for Series 3c compatibility) 


I Clears flags set by SETFLAGS 
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FINDLIB, GETLIBH 


NEWOBJ, NEWOBJH 


SEND, ENTERSEND, 
ENTERSENDO 


ALLOC 
FREEALLOC 
REALLOC 
ADJUSTALLOC 
LENALLOC 


CACHETIDY 


CACHEHDR 


CACHEREC 


SETFLAGS 


CLEARFLAGS 


